package com.ruoyi.qif.service;

import java.io.IOException;
import java.math.BigDecimal;
import java.util.List;

import com.ruoyi.qif.domain.BillImageUploadDTO;
import com.ruoyi.qif.domain.QifBill;

/**
 * 琦风公寓-每月账单Service接口
 *
 * @author David
 * @date 2025-10-05
 */
public interface IQifBillService {
    /**
     * 上传账单图片核心逻辑
     * @param dto 上传参数
     * @return 图片访问URL
     * @throws Exception 异常（账单不存在、解码失败、存储失败等）
     */
    String uploadBillImage(BillImageUploadDTO dto) throws Exception;

    /**
     * 查询琦风公寓-每月账单
     *
     * @param billId 琦风公寓-每月账单主键
     * @return 琦风公寓-每月账单
     */
    public QifBill selectQifBillByBillId(Long billId);

    /**
     * 获取本月账单中所有去重的交租日
     *
     * @return 交租日列表（Long类型，如[1,5,10,20]）
     */
    List<Long> getDistinctRentPayDates();

    /**
     * 查询琦风公寓-每月账单列表
     *
     * @param qifBill 琦风公寓-每月账单
     * @return 琦风公寓-每月账单集合
     */
    public List<QifBill> selectQifBillList(QifBill qifBill);

    /**
     * 新增琦风公寓-每月账单
     *
     * @param qifBill 琦风公寓-每月账单
     * @return 结果
     */
    public int insertQifBill(QifBill qifBill);

    /**
     * 新增琦风公寓-生成本月账单
     *
     * @return 结果
     */
    public int generateCurrentMonthBills();

    /**
     * 修改琦风公寓-每月账单
     *
     * @param qifBill 琦风公寓-每月账单
     * @return 结果
     */
    public int updateQifBill(QifBill qifBill);

    /**
     * 批量删除琦风公寓-每月账单
     *
     * @param billIds 需要删除的琦风公寓-每月账单主键集合
     * @return 结果
     */
    public int deleteQifBillByBillIds(String billIds);

    /**
     * 删除琦风公寓-每月账单信息
     *
     * @param billId 琦风公寓-每月账单主键
     * @return 结果
     */
    public int deleteQifBillByBillId(Long billId);

    void updateBillCell(Long billId, String fieldName, BigDecimal fieldValue);


}
